src/logger.ts (1)

54-58: Consider validating LOG_LEVEL environment variable.

The cast process.env.LOG_LEVEL as LogLevel accepts any string at runtime. If an invalid log level is provided (e.g., LOG_LEVEL=verbose), the behavior depends on the library's handling of unknown levels.

💡 Suggested validation

+const validLogLevels = ["trace", "debug", "info", "warning", "error", "fatal"] as const;
+const getLogLevel = (): LogLevel => {
+  const level = process.env.LOG_LEVEL;
+  if (level && validLogLevels.includes(level as LogLevel)) {
+    return level as LogLevel;
+  }
+  return "warning";
+};
+
 export const configureLogger = async (): Promise<void> =>
   configure({
     // ...
     loggers: [
       // ...
       {
         category: "octomind",
-        lowestLevel: (process.env.LOG_LEVEL as LogLevel) || "warning",
+        lowestLevel: getLogLevel(),
         sinks: ["console"],
       },
     ],
   });

src/cli.ts (1)

152-155: Note: -b shorthand has different meanings across commands.

The debug command uses -b for --bearer-token, while the execute command (line 174) uses -b for --browser. This is technically valid since they're separate commands, but could cause user confusion.

Consider using a different shorthand (e.g., -B or --bearer-token only without shorthand) for consistency, or document this distinction clearly.

src/tools/test-cases.ts (1)

138-142: Improve error handling for bearer token fetch.

The current error handling only uses res.statusText which may not provide sufficient debugging information. Consider including the response body for non-ok responses.

💡 Suggested improvement

   if (res.ok) {
     const response = await res.json();
     return response;
   }
-  throw new Error(`no test cases found. error: ${res.statusText}`);
+  let errorDetail = res.statusText;
+  try {
+    const errorBody = await res.text();
+    if (errorBody) {
+      errorDetail = `${res.status} ${res.statusText}: ${errorBody}`;
+    }
+  } catch {
+    // Ignore if we can't read the body
+  }
+  throw new Error(`Failed to fetch test cases: ${errorDetail}`);
 }

src/tools/environments.ts (1)

54-57: Add type assertion for consistency with other bearer token paths.

The res.json() call returns an untyped value. For consistency with src/tools/playwright.ts (which uses as PlaywrightCodeResponse), consider adding a type assertion here.

♻️ Suggested improvement

     if (res.ok) {
-      const environments = await res.json();
+      const environments = (await res.json()) as EnvironmentResponse[];
       return environments;
     }

src/tools/playwright.ts (1)

17-29: Redundant conditional spreads for required fields.

url and outputDir are required in the function signature, so the conditional checks options.url && and options.outputDir && are unnecessary. Additionally, if these fields were empty strings (which satisfies the type but is falsy), they would be incorrectly omitted from the query params.

♻️ Suggested improvement

     const params = new URLSearchParams({
       ...(options.environmentId && { environmentId: options.environmentId }),
-      ...(options.url && { url: options.url }),
-      ...(options.outputDir && { outputDir: options.outputDir }),
+      url: options.url,
+      outputDir: options.outputDir,
       ...(options.headless !== undefined && {
         headless: options.headless.toString(),
       }),